home *** CD-ROM | disk | FTP | other *** search
/ Software Vault: The Diamond Collection / The Diamond Collection (Software Vault)(Digital Impact).ISO / cdr29 / umsmtp02.zip / ULTIMAIL.TXT < prev    next >
Text File  |  1995-02-05  |  23KB  |  579 lines

  1. ******************************************************************************
  2. File: ultimail.txt                       Version 2.0               05-Feb-1995
  3.                                          Niel Kempson <kempson@snowyowl.co.uk>
  4. ******************************************************************************
  5.  
  6.  
  7. Configuring UltiMail/2 Lite for SMTP Mail
  8. =========================================
  9.  
  10.  
  11. Contents
  12. --------
  13.  
  14.      1. Introduction
  15.      2. Warning
  16.      3. Assumptions
  17.      4. Starting UltiMail/2
  18.      5. Configuring UltiMail/2
  19.      6. Testing your UltiMail/2 setup
  20.      7. Supporting more than one mail user
  21.      8. Frequently encountered problems (FEPs)
  22.      9. What if it still doesn't work ?
  23.     10. Useful references
  24.     11. Change log
  25.  
  26.  
  27.  
  28. 1. Introduction
  29. ---------------
  30.  
  31. UltiMail/2 Lite is supplied as part of the Internet Access Kit (IAK)
  32. accompanying the new OS/2 Warp 3.  UltiMail/2 Lite is described and
  33. configured by IBM as a mail client using the Post Office Protocol (POP) to
  34. exchange mail with a designated server machine.  Some Internet access
  35. provides offer POP servers, but some do not and assume that your site is
  36. capable of using the standard SMTP (Simple Mail Transfer Protocol) services.
  37.  
  38. Many Internet access providers prefer to deliver mail to subscribers
  39. using the standard SMTP (Simple Mail Transfer Protocol) services rather
  40. than POP - a notable example is Demon Internet Services in the UK (20,000
  41. subscribers in January 1995 and rising at 10% a month).  The provider
  42. benefits from using SMTP rather than POP because he doesn't need to
  43. provide a permanent mailbox account for each subscriber.
  44.  
  45. This small kit describes how to set up your Warp/IAK system to use
  46. UltiMail/2 Lite as your mail package and exchange mail with the outside
  47. world using SMTP rather than POP.  The instructions are by no means
  48. comprehensive and they are probably unclear in places so please feed back
  49. any constructive suggestions (including typos) to improve this kit.  All
  50. of the information in this guide has been gleaned from books, examination
  51. of binary files etc.  There's nothing in here that could possibly be
  52. construed as official IBM information.
  53.  
  54.  
  55.  
  56. 2. Warning
  57. ----------
  58.  
  59. The standard Warp/IAK setup assumes that you will be using POP to
  60. exchange your e-mail with Advantis.  If you're not sure that you need to
  61. use SMTP, please check whether your provider supports POP before acting
  62. on the recommendations in this kit.  IBM will certainly tell you that
  63. using Warp/IAK with SMTP is unsupported, but if you need SMTP support,
  64. you have little/no choice.
  65.     
  66. If you're an Advantis customer, you use POP and don't need this kit for
  67. your Advantis connection.
  68.  
  69. If you're a Demon Internet customer, you will need this kit unless you
  70. have paid up for the POP delivery service - it's an extra UKP 180 a year
  71. so you'll know :-)
  72.  
  73.  
  74.  
  75. 3. Assumptions
  76. --------------
  77.  
  78. Throughout this document I have assumed that the IAK software has been
  79. installed under the C:\TCPIP directory.  If you have not installed it in
  80. this directory, you will need to adjust the examples quoting files
  81. specifications to suit your system setup.
  82.  
  83. I have also assumed that you have acquired and installed the latest fixes
  84. to UltiMail/2.  At the time of writing, the latest fix was described by
  85. IBM thus:
  86.  
  87.     Ultimedia Mail/2 Lite fixes (last updated February 2, 1995)
  88.     -----------------------------------------------------------
  89.  
  90.     This package provides fixes to several problems in Ultimail.  A paste
  91.     of large volumes of text into the text editor from the clipboard
  92.     would trap.  Second, if the POP server were to drop the session
  93.     during mail retrieval, the Ultimail inbasket would hang.  Third, mail
  94.     sending would fail under certain circumstances, for example if your
  95.     Internet provider name server did not have a host name for your IP
  96.     address.  These problems are fixed with this package.
  97.  
  98.     Contents:
  99.  
  100.         17977  12-19-94  17:00   umail/OBJMLE.DLL
  101.         18143  12-21-94  15:38   umail/PIPETCP.DLL
  102.         10146  12-21-94  18:18   umail/POP.DLL
  103.        103714  01-31-95  13:21   bin/sendmail.exe
  104.  
  105. Do *NOT* install this new version of sendmail (1.3.10) - keep the
  106. original version (1.3.6).  It appears to be safe to install the 3 DLL
  107. files.
  108.  
  109. It's available by starting the "Retrieve Software Updates" object or by
  110. issuing the command "gopher updates.gopher.ibm.com 77".
  111.  
  112.  
  113.  
  114. 4. Starting UltiMail/2 Lite
  115. ---------------------------
  116.  
  117. The standard installation of the IAK creates an "Ultimedia Mail/2 'Lite'"
  118. folder containing objects like "In-basket", "Mail Cabinet".  They are not
  119. program objects with customisable setting and launching UltiMail/2 from
  120. them gives you no scope to adjust UltiMail/2's behaviour.
  121.  
  122. If you wish to change the default startup behaviour of UltiMail/2, you'll
  123. find it more convenient to create a program object with these parameters:
  124.  
  125.     Path and file name:     C:\TCPIP\UMAIL\UMAIL.EXE
  126.     Parameters:             /PRO=UMAIL.PRO
  127.     Working directory:      C:\TCPIP\UMAIL
  128.     Title:                  UltiMail/2 Lite    
  129.     
  130. UltiMail/2 can be started with a variety of undocumented command line
  131. options.  After examining UMAIL.EXE with a Hex editor, I have found these
  132. options:
  133.  
  134.     /U=<user>           the user ID is <user>
  135.     /PW=<password>      the password for the user ID is <password>
  136.     /PRO=<file>         use <file> as the profile file
  137.     /MIN                start minimised
  138.     /MAX                start maximised
  139.     /LOGO               display the UltiMail/2 logo at startup
  140.     /NOLOGO             don't display the UltiMail/2 logo at startup
  141.     /VGA                use only VGA resolution resources
  142.  
  143.     /LOGLEVEL=<level>   generate logging information according to the
  144.                         value of <level>, which can be one of:
  145.  
  146.                             C_FLOW          internal program flow
  147.                             INFO            information messages
  148.                             WARNING         warning messages
  149.                             ERROR           error messages
  150.                             OUTPUT          ??
  151.                             NONE            nothing
  152.  
  153.                         A value of <level> includes all of the categories
  154.                         above it (i.e. INFO includes WARNING, ERROR &
  155.                         OUTPUT, but not C_FLOW).
  156.  
  157.     /LOGDEST=<dest>     send the logging information to <dest>, which can
  158.                         be one of:
  159.  
  160.                             FILE        log to C:\TCPIP\UMAIL\UMAIL.LOG
  161.                             PM          log to a PM window
  162.                             FILEPM      combined FILE and PM
  163.                             NONE        no logging
  164.     
  165.  
  166. When UltiMail/2 starts up, it initialises itself using information from
  167. two sources:
  168.  
  169.     o   firstly, from the UltiMail/2 profile file specified by the
  170.         /PRO=<file> option, or C:\TCPIP\UMAIL\UMAIL.PRO if /PRO is not
  171.         specified
  172.         
  173.     o   secondly, from the hidden configuration file defined by the
  174.         PROFILE section of the UltiMail/2 profile file.  It usually looks
  175.         like this:
  176.  
  177.             :PROFILE       provider         = 'ADVANTIS'
  178.                            file             = 'C:\tcpip\ETC\TCPOS2.INI'
  179.                            .
  180.  
  181.         This hidden file is created and updated by the IBM dialer
  182.         programs ("IBM Internet Dialer" or "Dial Other Internet
  183.         Providers" objects).
  184.  
  185.  
  186.  
  187. 5. Configuring UltiMail/2 Lite
  188. ------------------------------
  189.  
  190. o   This section will configure UltiMail/2 to use only the profile file
  191.     to determine its setup.  Before you start, make sure that you save
  192.     these configuration files:
  193.  
  194.         C:\TCPIP\UMAIL\*.PRO
  195.         C:\TCPIP\ETC\SENDMAIL.UML
  196.         C:\TCPIP\ETC\*.INI
  197.  
  198. o   Make sure that the PPP/SLIP connection and UltiMail/2 are not running.
  199.  
  200. o   Copy the example files UMAIL.PRO and UMAILSRV.PRO that came with this
  201.     kit to C:\TCPIP\UMAIL.
  202.  
  203. o   Create a program object for UltiMail/2 with these parameters:
  204.  
  205.         Path and file name:     C:\TCPIP\UMAIL\UMAIL.EXE
  206.         Parameters:             /PRO=UMAIL.PRO
  207.         Working directory:      C:\TCPIP\UMAIL
  208.         Title:                  UltiMail/2 Lite    
  209.  
  210. o   Start UltiMail/2 from this freshly created object.  If you see a
  211.     pop-up box entitled "Not Connected to the Internet", click on the
  212.     "Don't connect" button.
  213.  
  214. o   If you see a pop-up box entitled "Accessing a network", make sure
  215.     that you have copied across the example profile files.
  216.  
  217. o   When UltiMail is a little over halfway through its loading process,
  218.     another pop-up box entitled "Accessing a Mail Server" will appear.
  219.     Since you're using SMTP, you should make sure that the four fields
  220.     contain these values:
  221.             
  222.         User ID:    yourid
  223.         Password:   *** must be empty ***
  224.         Server:     *** must be empty ***
  225.         Port:       110
  226.  
  227.     Don't change the "yourid" in the User ID field until you have
  228.     reconfigured UltiMail/2 at the next stage.  Click on the "Cancel"
  229.     button because you don't want to connect to a POP server.
  230.  
  231. o   When the Mail Cabinet has started, click on the "Cabinet" menu and
  232.     then the "Settings" item of that menu.  A typical OS/2 settings
  233.     notebook entitled "UltiMail - Settings" will appear.  The settings
  234.     will be for the mythical user ID "yourid" and you should change them
  235.     as summarised below.  (You can customise them to your heart's content
  236.     once it's all working, but please bear with me until it is.)
  237.     
  238.     Profile, page 1 of 6
  239.  
  240.         Name:           your name (e.g. John Smith)
  241.         ID:             your email user ID (e.g. jsmith)
  242.         Password:       just put an asterisk here (*)
  243.  
  244.     Profile, page 2 of 6
  245.  
  246.         From:           edit the "From:" line that will be attached to
  247.                         your messages.  It should be something like:
  248.                         
  249.                             John Smith <jsmith@host.domain>
  250.  
  251.         Reply-To:       edit the "Reply-To:" line that will be attached to
  252.                         your messages.  It should be something like:
  253.                         
  254.                             John Smith <jsmith@host.domain>
  255.  
  256.         Address:        select "Medium"
  257.  
  258.         Signature:      edit to suit your signature (try to keep it to
  259.                         "-- " plus four lines or you'll attract a number
  260.                         of flame messages)
  261.  
  262.         Create:         select "Text / plain"
  263.         
  264.     Profile, page 3 of 6
  265.     
  266.         Separator:                      check and set to 
  267.                                         "//--- forwarded letter ---"
  268.         Annotation:                     check and set text to "> "
  269.         Signature placement:            select "After"
  270.         View all letters in one window: check
  271.         Beep on new mail:               check
  272.  
  273.     Profile, page 4 of 6
  274.  
  275.         Client Sessions:            select "Local Mail"
  276.         DLL:                        select "CSELOCL"
  277.         Pipe:                       select "PIPELOCL"
  278.         UserID:                     *** must be empty ***
  279.         Password:                   *** must be empty ***
  280.         Retry:                      set to 3
  281.         Interval:                   set to 5
  282.         Logon:                      check "automatically"
  283.         Color:                      select "blue"
  284.         
  285.     Profile, page 5 of 6
  286.     
  287.         Don't touch anything on this page!
  288.         
  289.     Profile, page 6 of 6
  290.  
  291.         Select the right time zone information for your area.  For the
  292.         UK, this is:
  293.         
  294.         Time Zone:                  Europe - England
  295.         Switch to summer time:      Last Sunday of March
  296.         Switch to standard time:    Last Sunday of October        
  297.  
  298. o   Close down the settings notebook and the the UltiMail/2 Mail Cabinet.
  299.     UltiMail/2 should now be ready for use with SMTP.  
  300.     
  301. o   Restart UltiMail/2 from the program icon.  When the "Accessing a Mail
  302.     Server" pop-up box appears, the User ID field should now contain your
  303.     real e-mail user ID (as entered on page 1 of the settings notebook).
  304.     Click on the "Cancel" button because you don't want to connect to a
  305.     POP server.  Unfortunately, you can't stop this pop-up box appearing.
  306.  
  307.     The title bar of the Mail Cabinet should show your real name rather
  308.     than the previous string "Your Name".
  309.  
  310.  
  311.  
  312. 6. Testing Your Setup
  313. ---------------------
  314.  
  315. o   make sure that the mail queue directory (C:\TCPIP\ETC\MQUEUE) is
  316.     empty
  317.  
  318. o   delete or rename the UMAIL.LOG and UMAIL.ERR files in C:\TCPIP\UMAIL
  319.  
  320. o   delete or rename the SENDMAIL.LOG and SENDMAIL.ERR files in
  321.     C:\TCPIP\ETC
  322.  
  323. o   make sure that the PPP/SLIP connection is NOT running, start UltiMail/2
  324.     Lite from the program icon and then open the In-Basket window.
  325.  
  326. o   Compose a message to yourself at your local mail address 
  327.     (e.g yourid@yourhost.your.domain) and send it.  You should see a
  328.     pop-up box entitled "Letter Sent or Queued Successfully" and the
  329.     In-box will chime soon afterwards as your message is delivered.
  330.  
  331. o   Now compose a message to an external "mail mirror" that will send
  332.     your message back to you.  A good example is "bouncer@nic.near.net".
  333.     Again, you should see a pop-up box entitled "Letter Sent or Queued
  334.     Successfully" but the message will not be delivered until the
  335.     PPP/SLIP connection and the sendmail daemon are started.
  336.     
  337.     If you have a look in the mail queue directory (C:\TCPIP\ETC\MQUEUE),
  338.     you should see two files called dfAAxxxx and qfAAxxxx, where xxxx is
  339.     a four digit number.
  340.  
  341.     The file dfAAxxxx contains your message and qfAAxxx is the control file
  342.     that contains the mail headers and other information.  It should be in a
  343.     similar format to this:
  344.  
  345.         P1515
  346.         T791920800
  347.         DdfAA0050
  348.         Skempson
  349.         Rbouncer@nic.near.net
  350.         H?P?return-path: <kempson@snowyowl.demon.co.uk>
  351.         Hreceived: by snowyowl.demon.co.uk 
  352.                 (IBM OS/2 SENDMAIL VERSION 1.3.6)/(1.1sos)
  353.             id AA0050; Sat, 04 Feb 95 18:00:00 GMT
  354.         H?x?full-name: 
  355.         H?M?message-id: <9502041800.AA0050@snowyowl.demon.co.uk>
  356.         Hmime-version: 1.0
  357.         Hdate: Sat, 04 Feb 95 17:59:39 +0000
  358.         HFrom: Niel Kempson <kempson@snowyowl.co.uk>
  359.         HTo: "Nearnet bouncer" <bouncer@nic.near.net>
  360.         HReply-To: Niel Kempson <kempson@snowyowl.co.uk>
  361.         Hsubject: Bounce Request
  362.         Hx-mailer: Ultimedia Mail/2 Lite, IBM T. J. Watson Research Center
  363.         Hcontent-type: text/plain; charset="US-ASCII"
  364.         Hcontent-id: <37_63_1_791938780>
  365.         Hcontent-transfer-encoding: 7Bit
  366.         Hcontent-description: <none>
  367.  
  368. o   make sure that the UltiMail/2 In-Basket window is still open, then start
  369.     the  connection and then the sendmail daemon (see section 3 above).
  370.     Just after the sendmail daemon starts, you should see a message in its
  371.     window saying that it has delivered a mail message to you and UltiMail/2
  372.     will chime shortly afterwards.
  373.     
  374. o   try sending some external mail messages to make sure that mail is
  375.     accepted from other hosts.  Three automatic ways spring to mind:
  376.     
  377.     o   send to a mail "mirror" that automatically replies to you.  The
  378.         only example that I know of is "bouncer@nic.near.net".
  379.  
  380.     o   send mail to yourself via another system using the "percent hack".
  381.         E.g. I can send to "kempson%snowyowl.com@post.demon.co.uk" to make
  382.         the mail go to post.demon.co.uk before coming back to me;
  383.         
  384.     o   send a "help" message to one of the Bitnet list servers.  E.g. send a
  385.         message to "listserv@hearn.nic.surfnet.nl" with a message text of
  386.         "help".
  387.     
  388.     Whichever method you use should result in a reply, possibly within a
  389.     minute if your network connection is lightly loaded.  When the reply
  390.     arrives, UltiMail/2 should chime again.
  391.  
  392.  
  393.  
  394. 7. Supporting more than one mail user
  395. -------------------------------------
  396.  
  397. UltiMail/2 can support incoming mail for more than one mail user ID, but
  398. you need to customise its profile for each user ID.  As an example, I'll
  399. assume that you want to support mail for John Smith (mail user ID:
  400. jsmith) and Alice Jones (mail user ID: ajones).
  401.  
  402. o   copy the reference UMAIL.PRO file to create a profile file for each
  403.     of the users:
  404.     
  405.         COPY C:\TCPIP\UMAIL\UMAIL.PRO C:\TCPIP\UMAIL\JSMITH.PRO
  406.         COPY C:\TCPIP\UMAIL\UMAIL.PRO C:\TCPIP\UMAIL\AJONES.PRO
  407.  
  408. o   Create a program object for each of the mail user IDs:
  409.  
  410.     For John Smith:
  411.         
  412.         Path and file name:     C:\TCPIP\UMAIL\UMAIL.EXE
  413.         Parameters:             /PRO=JSMITH.PRO
  414.         Working directory:      C:\TCPIP\UMAIL
  415.         Title:                  UltiMail/2 Lite (John Smith)
  416.  
  417.     For Alice Jones:
  418.     
  419.         Path and file name:     C:\TCPIP\UMAIL\UMAIL.EXE
  420.         Parameters:             /PRO=AJONES.PRO
  421.         Working directory:      C:\TCPIP\UMAIL
  422.         Title:                  UltiMail/2 Lite (Alice Jones)
  423.  
  424. o   For each user, start UltiMail/2 from the appropriate program icon and
  425.     follow the steps in section 5 to configure it for that user's details.  
  426.  
  427. o   After configuration, you'll be able to double click on the
  428.     appropriate program icon and read/send mail as John Smith or Alice
  429.     Jones.
  430.  
  431. o   It is only possible to run one copy of UltiMail/2 at any one time.
  432.     
  433. o   When the PPP/SLIP link is running, you will only be able to open one
  434.     UltiMail/2 In-box folder to detect incoming mail for that particular
  435.     user.  The simplest way to look at incoming mail is to open the
  436.     sendmail daemon window - if you start sendmail with the "-d1.1"
  437.     option, it will log all incoming mail messages, but you won't get any
  438.     sounds :-(
  439.  
  440.  
  441.  
  442. 8. Frequently encountered problems (FEPs)
  443. -----------------------------------------
  444.  
  445. The most common problems encountered with UltiMail/2 are summarised below.
  446.  
  447.  
  448. Problem:    When starting UltiMail/2, it presents a "Not Connected to the 
  449.             Internet" pop-up box.
  450.  
  451. Reason:     Your PPP/SLIP connection is not active and UltiMail/2 is
  452.             offering to launch the dialer program.  It's perfectly safe
  453.             just to click on the "Don't connect" button if you want to
  454.             read or compose mail off-line.
  455.  
  456.  
  457. Problem:    When starting UltiMail/2, it presents an "Accessing a
  458.             Network" pop-up box.
  459.         
  460. Reason:     UltiMail/2 probably doesn't have enough configuration for the
  461.             desired user name.  You may not have started with the example
  462.             profile files provided with this kit.
  463.  
  464.  
  465. Problem:    When starting UltiMail/2, it presents an "Accessing a Mail
  466.             Server" pop-up box.
  467.             
  468. Reason:     UltiMail/2 is a POP mailer at heart and it wants to know the
  469.             information needed to connect to a POP server to collect your
  470.             mail.  Since you're using SMTP, you should make sure that the
  471.             four fields contain these values:
  472.             
  473.                 
  474.                 User ID:    <your e-mail user ID>
  475.                 Password:   *** must be empty ***
  476.                 Server:     *** must be empty ***
  477.                 Port:       110
  478.  
  479.             Click on the "Cancel" button because you don't want to
  480.             connect to a POP server.  Unfortunately, you can't stop this
  481.             pop-up box appearing.
  482.  
  483.  
  484. Problem:    Can't change the UltiMail/2 settings because the "settings"
  485.             menu is greyed out.
  486.         
  487. Reason:     UltiMail/2 probably doesn't have enough configuration for the
  488.             desired user name.  You may not have started with the example
  489.             profile files provided with this kit.
  490.  
  491.  
  492. Problem:    I never get any incoming mail, even though other SMTP
  493.             packages on my system can receive mail.
  494.  
  495. Reason:     You need to ensure that the sendmail daemon is always running
  496.             while your PPP/SLIP connection is running.  Details of
  497.             running and configuring sendmail can be found in the
  498.             accompanying sendmail.txt file.
  499.  
  500.  
  501. Problem:    I never get any messages in my "Received" mail folder.
  502.  
  503. Reason:     Incoming messages are always put into the "In-basket" mail
  504.             folder, which unfortunately, isn't opened automatically when
  505.             you start UltiMail/2 as a program icon.
  506.  
  507.  
  508. Problem:    After sending a mail message, you receive a message from
  509.             MAILER-DAEMON reporting a sendmail error 65.
  510.  
  511. Reason:     Sendmail couldn't connect to the destination host, even
  512.             though it thinks that the network is running.  The mail will
  513.             be queued for transmission later.  See the companion file
  514.             sendmail.txt.
  515.  
  516.  
  517. Problem:    After sending a mail message, you receive a message from
  518.             MAILER-DAEMON reporting sendmail error 68.
  519.  
  520. Reason:     Sendmail can't resolve the IP address of the destination
  521.             host, usually because the DNS is unreachable (you're
  522.             off-line) and the host isn't in your HOSTS file.  The message
  523.             will be bounced back to you.  See sendmail.txt.
  524.  
  525.                 
  526.  
  527. 9. What if it still doesn't work ?
  528. ----------------------------------
  529.  
  530. Unfortunately, there are many things that can go wrong with SMTP mail.  The
  531. clues will usually be found in the log and error files created by sendmail
  532. and UltiMail/2:
  533.  
  534.     C:\TCPIP\ETC\SENDMAIL.ERR
  535.     C:\TCPIP\ETC\SENDMAIL.LOG
  536.     C:\TCPIP\UMAIL\UMAIL.ERR
  537.     C:\TCPIP\UMAIL\UMAIL.LOG
  538.     
  539. It is possible to make sendmail and UltiMail/2 create large quantities of
  540. debugging information by specifying appropriate command line options.
  541.  
  542. Sendmail: start it with the "-d" option (see sendmail.txt for more
  543. details).
  544.  
  545. UltiMail/2: start it with the command line options 
  546.  
  547.         /LOGLEVEL=C_FLOW /LOGDEST=FILE
  548.  
  549.  
  550.  
  551. 10. Useful references
  552. ---------------------
  553.  
  554. Internet RFCs providing useful information about SMTP and POP services
  555. and mail:
  556.  
  557.     RFC-822     Standard for the format of ARPA Internet text messages.
  558.     RFC-1123    Requirements for Internet hosts - application and support.  
  559.     RFC-1082    Post Office Protocol: Version 3: Extended service offerings.  
  560.     RFC-1225    Post Office Protocol version 3
  561.  
  562. RFCs are available by ftp from many sites, including:
  563.  
  564.     flash.bellcore.com:/pub/rfc
  565.     ftp.demon.co.uk:/pub/doc/rfc
  566.     gatekeeper.dec.com:/.3/net/info/rfc
  567.     munnari.oz.au:/rfc
  568.     nic.ddn.mil:/rfc
  569.     sunsite.doc.ic.ac.uk:/pub/rfc
  570.  
  571.  
  572. 11. Change log
  573. --------------
  574.  
  575.     2.0 [05-Feb-1995] Niel Kempson <snowyowl.co.uk>
  576.         Initial version in the revised format.
  577.  
  578. ********************************* END OF FILE ********************************
  579.